<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
  <head>
    <meta name="generator"
    content="HTML Tidy for Windows (vers 14 February 2006), see www.w3.org" />
    <meta http-equiv="CONTENT-TYPE" content="text/html; charset=utf-8" />
    <title>@APPNAME@ User&#39;s Guide, version @VERSION@, 2. Running @APPNAME@</title>
    <meta name="keywords" content="" />
    <meta name="description" content="" />
    <link href="default.css" rel="stylesheet" type="text/css" />
    <style type="text/css">
 div.c8 {font-size: 80%; text-align: right}
 div.c7 {text-align: center}
 div.c6 {margin-left: 20px;}
 p.c5 {margin-left: 2cm;}
 span.c4 {font-size: 80%}
 span.c3 {color: #663366}
 span.c2 {font-family: monospace}
 div.c1 {margin-left: 20px;}
</style>
  </head>
  <body lang="en-US">
    <table border="0" width="100%">
      <tr>
        <td align="left">@APPNAME@ User&#39;s Guide</td>
        <td align="right">
        <a href="#top">Top</a> | 
        <a href="Guide.html">Table of Contents</a> | 
        <a href="Guide1.html">Previous</a> | 
        <a href="Guide3.html">Next</a> | 
        <a href="TopicIndex.html">Topic Index</a></td>
      </tr>
    </table>
    <hr />
    <a name="top" id="top"></a>
    <h2>2. Installation</h2>
    <div class="c6">
    <h3>Requirements</h3>
    <p>
    <i>@APPNAME@ @VERSION@</i> is a Java application and runs on all major
    platforms including Microsoft Windows (98, 2000, XP, Vista, and Windows 7), various
    flavors of Linux and Unix, and MacOS X. It requires Java 2 Runtime
    Environment (J2RE) from 
    <a href="http://java.sun.com/">Sun Microsystems</a>. For Microsoft Windows,
    Linux, and Unix platforms, Java 6.0 or higher is required. For MacOS 10.4
    and 10.5, Java 5.0 or higher is required. It is highly recommended to run 
    <i>@APPNAME@ @VERSION@</i> with the latest release of Java.</p>

    <h3>Installation</h3>
    <p>
    <i>@APPNAME@ @VERSION@</i> is distributed in the following formats:</p>
    <ul>
      <li>Microsoft Windows executable installer ( 
      <tt>.exe</tt>, Microsoft Windows)</li>
      <li>JAR executable installer ( 
      <tt>.jar</tt>, Linux/Unix and Microsoft Windows)</li>
      <li>MacOS X disk image with installer ( 
      <tt>.dmg</tt>, MacOS X)</li>
      <li>JAR executable installer for MacOS X ( 
      <tt>.jar</tt>, MacOS X)</li>
      <li>ZIP compressed archive format ( 
      <tt>.zip</tt>, all platforms)</li>
      <li>JAR compressed archive format ( 
      <tt>.jar</tt>, all platforms)</li>
      <li>Gzipped-tar compressed archive format ( 
      <tt>.tar.gz</tt>, all platforms)</li>
    </ul>
    <h4>Installation with Microsoft Windows Executable Installer</h4>
    <ul>
      <li>Download the Microsoft Windows executable installer ( 
      <tt>.exe</tt>) file and save it to your local disk.</li>
      <li>Double click on the executable installer file to launch the
      installer.</li>
      <li>Follow the instruction and proceed with installation.</li>
    </ul>
    <p>An installation directory will be created and shortcuts will be added to
    the start-up menu and to the desktop. You can use the shortcuts to launch
    the @APPNAME@. A shortcut for uninstalling the @APPNAME@ is also
    included.</p>
    <h4>Installation with MacOS X Disk Image</h4>
    <ul>
      <li>Download the MacOS X disk image with installer ( 
      <tt>.dmg</tt>) file and save it to your local disk.</li>
      <li>Double click on the disk image file, a new removable disk is
      mounted.</li>
      <li>Locate the removable disk in your Finder window, you should find a
      single installer file on the removable disk.</li>
      <li>Double click on the installer file to launch the installer.</li>
      <li>Follow the instruction and proceed with installation.</li>
      <li>Unmount the removable disk when the installation is completed.</li>
    </ul>
    <p>An installation directory will be created. Click on the 
    <tt>@PRODUCT@</tt> application under the installation directory to
    launch the @APPNAME@. An uninstaller is available under the 
    <tt>Uninstaller</tt> subdirectory of the installation directory.</p>
    <h4>Installation with Jar Installer</h4>
    <ul>
      <li>Download the cross-platform Jar installer ( 
      <tt>.jar</tt>) file and save it to your local disk.</li>
      <li>Double click on the Jar installer file to launch the installer. The
      Jar installer can also be launched by executing the following command at
      the command prompt.
      <pre>
            java -jar &lt;jar-installer file&gt;
          
</pre></li>
      <li>Follow the instruction and proceed with installation.</li>
    </ul>
    <p>An installation directory will be created. The installer will also
    create a program group and a desktop shortcut. You can use the program menu
    or the shortcut to launch the @APPNAME@. An uninstaller is available
    under the Uninstaller subdirectory of the installation directory.</p>
    <h4>Installation with Zip/Gzip/Jar Archives</h4>
    <ul>
      <li>Download the zip or gzip or jar archive file and save it to your
      local disk.</li>
      <li>Unpack the archive file directly to the installation directory.</li>
    </ul>
    <p>After unpacking, the following files and sub-directories can be found
    under the installation directory</p>
    <pre>
  INSTALL.html
  LICENSE.txt  
  LICENSE-THIRD-PARTIES.txt  
  README.html
  README.txt
  bin/
  doc/
  examples/
  lib/
      
</pre>
    <h3>Running 
    <i>@APPNAME@</i></h3>
    <p>After the installation is complete, you should find the following
    sub-directories under the installation directory of 
    <i>@APPNAME@ @VERSION@</i>,</p>
    <div class="c1">
      <table border="0" cellpadding="2" cellspacing="0">
        <tbody>
          <tr>
            <td valign="top">
              <tt>bin</tt>
            </td>
            <td valign="top">This sub-directory contains the run scripts for
            various platforms.</td>
          </tr>
          <tr>
            <td valign="top">
              <tt>lib</tt>
            </td>
            <td valign="top">This sub-directory contains the library files (jar
            files).</td>
          </tr>
          <tr>
            <td valign="top">
              <tt>doc</tt>
            </td>
            <td valign="top">This sub-directory contains the
            documentation.</td>
          </tr>
          <tr>
            <td valign="top">
              <tt>examples</tt>
            </td>
            <td valign="top">This sub-directory contains the example drawings.
            This sub-directory is optional. It will be present if you select
            the 
            <i>Examples</i> package during installation.</td>
          </tr>
        </tbody>
      </table>
    </div>
    <p>In most cases, if you have used the executable or JAR installer for the
    installation, you can launch 
    <i>@APPNAME@</i> from the menu or the desktop shortcut. For MacOS,
    click on the 
    <tt>@PRODUCT@</tt> application under the installation directory to
    launch
    <i>@APPNAME@</i>.</p>

    <p>You may also use the run scripts provided for various platforms to
    launch the 
    <i>@APPNAME@</i>. It will be convenient to add the following path to
    your 
    <tt>PATH</tt> environment variable:</p>
    <p class="c5">
    <span class="c4">
    <u>
      <i>
        <span class="c3">&lt;installation directory&gt;</span>
      </i>
    </u> 
    <span class="c2">/bin</span></span> (for Linux/Unix)</p>
    <p class="c5">
    <span class="c4">
    <u>
      <i>
        <span class="c3">&lt;installation directory&gt;</span>
      </i>
    </u> 
    <span class="c2">\bin</span></span> (for Microsoft Windows)</p>
    <p>Type 
    <tt>@CMD@</tt> at the command prompt to launch 
    <i>@APPNAME@</i>.</p>


    <p> On all platforms, you can always launch the 
    <i>@APPNAME@</i> from the command prompt using the following
    command:</p>
    <p class="c5">
    <span class="c4">
    <span class="c2">java -Xmx512m -jar</span> 
    <u>
      <i>
        <span class="c3">&lt;installation directory&gt;</span>
      </i>
    </u> 
    <span class="c2">/lib/@CMD@.jar</span></span> (for Linux/Unix and MacOS)</p>
    <p class="c5">
    <span class="c4">
    <span class="c2">java -Xmx512m -jar</span> 
    <u>
      <i>
        <span class="c3">&lt;installation directory&gt;</span>
      </i>
    </u> 
    <span class="c2">\lib\@CMD@.jar</span></span> (for Microsoft Windows)</p>

    <h3>Loading the Examples</h3>
    <p>If the 
    <i>Examples</i> package is installed, you can load the examples after you
    have launches the 
    <i>@APPNAME@</i>.</p>
    <ol>
      <li>Select from the menu bar: Project | Open project, a file dialog will
      pop up.</li>
      <li>Change directory to the 
      <span class="c2">examples</span> subdirectory under the 
      <u>
        <i>
          <span class="c3">&lt;installation directory&gt;</span>
        </i>
      </u></li>
      <li>Choose the project file named 
      <tt>Examples.vmp</tt>, and click &quot;Open.&quot;</li>
    </ol>After the loading is complete, you should see the 
    <i>Examples</i> project in the project panel.
    <p>The 
    <i>Examples</i> package is also available as a project archive. You can
    load the examples from the project archive file as follows.</p>
    <ol>
      <li>Select from the menu bar: Project | Open project archive, a file
      dialog will pop up.</li>
      <li>Change directory to the 
      <span class="c2">examples</span> subdirectory under the 
      <u>
        <i>
          <span class="c3">&lt;installation directory&gt;</span>
        </i>
      </u></li>
      <li>Choose the project file named 
      <tt>Examples.par</tt>, and click &quot;Open.&quot;</li>
    </ol></div>
    <hr />
    <div class="c7">
    <a href="#top">Top</a> | 
    <a href="Guide.html">Table of Contents</a> | 
    <a href="Guide1.html">Previous</a> | 
    <a href="Guide3.html">Next</a> | 
    <a href="TopicIndex.html">Topic Index</a></div>
    <div class="c8">Copyright © @COPYYEAR@ @COPYRIGHT@</div>
  </body>
</html>
